Inside Macintosh: Telephony /

Chapter 6 - Telephone Tools

This chapter describes telephone tools and provides detailed information about writing them. It first discusses the general concepts relevant to writing a tool and then describes the six resources that are an essential part of a telephone tool. These six resources are analogous to the six resources that must be in any communications tool used by the Communications Toolbox.

To use this chapter, you should already be familiar with the Telephone Manager, described earlier in this book. A telephone tool communicates with the Telephone Manager by exchanging messages with it. You should also be familiar with the user interface guidelines for communications tools that are described in Appendix A of the book Inside the Macintosh Communications Toolbox.

IMPORTANT

You need to read this chapter only if you want to write a telephone tool. To use the general telephony services provided by the Telephone Manager or to handle application messages, see the chapters earlier in this book.

---

Chapter Contents

About Telephone Tools

Writing Telephone Tools

Constructing a Bundle Resource

Writing a Main Code Resource

Writing a Validation Code Resource

Writing a Setup-Definition Code Resource

Writing a Scripting Language Interface Code Resource

Writing a Localization Code Resource

Sending Messages to the Telephone Manager

Telephone Tools Reference

Constants

Telephone Tool Resource Types

Main Code Resource Messages

Validation Code Resource Messages

Setup-Definition Code Resource Messages

Scripting Language Interface Code Resource Messages

Localization Code Resource Messages

Terminal Messages

Directory Number Messages

Call Appearance Messages

Data Structures

Call Forwarding Parameter Block

Terminal Message Parameter Block

Directory Number Message Parameter Block

Call Appearance Generic Message Parameter Block

Call Appearance Disconnect Message Parameter Block

Call Appearance Conference Message Parameter Block

Call Appearance Transfer Message Parameter Block

Call Appearance Incoming or Outgoing Message Parameter Block

Setup-Definition Structure

Tool-Defined Functions

Telephone Tools Summary

C Summary

Constants

Data Types

Tool-Defined Functions

Pascal Summary

Constants

Data Types

Tool-Defined Functions